feat(analytics): add UTMs to docs signup links (GRO-86)#924
Conversation
So Growth can attribute new Arcade account creations back to docs — per-page campaigns for the three QuickStarts, generic `docs` elsewhere. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
…hes all - Default utm_campaign=docs (generic docs pages) - QuickStarts use utm_campaign=docs-quickstart-<slug> - Drop default utm_medium (most SignupLinks are inline prose, not CTAs) - Navbar uses utm_medium=navbar (matches marketing site convention) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
@teallarson This is great so we can figure out how many activated signups are coming from our old QuickStart activation path (arcade.dev > docs tools catalog > QuickStarts) and compare that to our new activation path via Gateways in Dashboard. I want to eventually answer if Dashboard or the CLI is a better place to activate users. Q before I sign off: Do the UTM params survive the full signup flow so Posthog associates these UTMS with a completed sign up? If there's an OAuth redirect or intermediate step that drops the query params, we'd lose the attribution (this has happened with past utms) |
I have a PR to test in our identity ui that should fix this. |
3 participants
Linear: GRO-86
Summary
SignupLinknow appends UTMs when routing toapp.arcade.dev/registerdocs-soutm_campaign startsWith "docs"catches everythingutm_source=docs,utm_campaign=docs(no medium)utm_medium=navbarutm_campaign=docs-quickstart-<slug>(call-tool-agent / call-tool-client / mcp-server)Test plan
?utm_source=docs&utm_campaign=docs&utm_medium=navbar/en/get-started/quickstarts/call-tool-agentSignupLink href includesutm_campaign=docs-quickstart-call-tool-agent/en/get-started/quickstarts/call-tool-clientSignupLink href includesutm_campaign=docs-quickstart-call-tool-client/en/get-started/quickstarts/mcp-server-quickstartSignupLink href includesutm_campaign=docs-quickstart-mcp-server?utm_source=docs&utm_campaign=docsutm_campaign startsWith "docs"onapp.arcade.dev/registerpageviews returns expected traffic🤖 Generated with Claude Code
Note
Low Risk
Small, additive change limited to link URL construction and a few doc pages; main risk is incorrect query param formatting or unexpected URL encoding.
Overview
Docs
SignupLinknow builds the/registerURL with UTM query params (utm_source=docs, defaultutm_campaign=docs, optionalutm_medium) while keeping the existing PostHog click event.Selected signup links in docs are updated to pass more specific attribution: the navbar adds
utm_medium=navbar, and the three QuickStart guides setutm_campaigntodocs-quickstart-*(plus an inline signup link in the MCP server quickstart).Reviewed by Cursor Bugbot for commit b170d91. Bugbot is set up for automated code reviews on this repo. Configure here.